home *** CD-ROM | disk | FTP | other *** search
/ Super Shareware Collection / Super Shareware Collection.iso / info / rcntx323.zip / TRANSFER.EXE / MANUAL < prev    next >
Text File  |  1992-06-21  |  42KB  |  856 lines

  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.  
  15.  
  16.  
  17.                             RACONTEX SEARCH SYSTEM
  18.  
  19.                             Instruction Manual For
  20.                         Loading/Indexing and Searching
  21.  
  22.                   Copyright (c) Edward Guy CDP 1987,8,9,90,1
  23.  
  24.  
  25.  
  26.  
  27.  
  28.  
  29.  
  30.  
  31. A product of:
  32.  
  33. GUY SOFTWARE
  34. 1752 Duchess Avenue
  35. West Vancouver
  36. British Columbia
  37. Canada      V7V 1P9                                         November 29, 1991
  38.  
  39.  
  40.                                    CONTENTS
  41.  
  42.      DISCLAIMER   . . . . . . . . . . . . . . . . . . . . . . . . . . . .   1
  43.  
  44.      RACONTEX FEATURES  . . . . . . . . . . . . . . . . . . . . . . . . .   2
  45.  
  46.      LOADING/INDEXING INSTRUCTIONS  . . . . . . . . . . . . . . . . . . .   5
  47.      Quick Start  . . . . . . . . . . . . . . . . . . . . . . . . . . . .   5
  48.  
  49.      MICROSOFT WINDOWS AND RACONTEX.  . . . . . . . . . . . . . . . . . .   6
  50.      FOR THE MORE TECHNICAL   . . . . . . . . . . . . . . . . . . . . . .   6
  51.      File Names   . . . . . . . . . . . . . . . . . . . . . . . . . . . .   7
  52.      Stopwords  . . . . . . . . . . . . . . . . . . . . . . . . . . . . .   7
  53.      Delimiters   . . . . . . . . . . . . . . . . . . . . . . . . . . . .   7
  54.      Formatting   . . . . . . . . . . . . . . . . . . . . . . . . . . . .   8
  55.      Merging Files  . . . . . . . . . . . . . . . . . . . . . . . . . . .   8
  56.      Copy Prevention  . . . . . . . . . . . . . . . . . . . . . . . . . .   9
  57.      For the REALLY technical   . . . . . . . . . . . . . . . . . . . . .   9
  58.      Program Limitations  . . . . . . . . . . . . . . . . . . . . . . . .  11
  59.  
  60.      SEARCH SYSTEM INSTRUCTIONS   . . . . . . . . . . . . . . . . . . . .  12
  61.      Simple Searches  . . . . . . . . . . . . . . . . . . . . . . . . . .  12
  62.      Display Options  . . . . . . . . . . . . . . . . . . . . . . . . . .  12
  63.      Word Proximity Searches  . . . . . . . . . . . . . . . . . . . . . .  15
  64.      Printer and File Output  . . . . . . . . . . . . . . . . . . . . . .  17
  65.  
  66.  
  67. Please note that  the SEARCH SYSTEM  INSTRUCTIONS can stand alone and  do not
  68. require an understanding of the LOADING/INDEXING INSTRUCTIONS. 
  69.  
  70. Racontex Manual                                                        Page 1
  71.     
  72.  
  73.  
  74.  
  75.  
  76.  
  77.  
  78.  
  79.  
  80.  
  81.  
  82.  
  83.  
  84.  
  85.  
  86.  
  87.  
  88.  
  89.  
  90.  
  91.  
  92.  
  93.  
  94. DISCLAIMER: The supplier has no liability to the licensee or any other person
  95. or  entity  for  any  damage   or  loss,  including  special,  incidental  or
  96. consequential damages caused  by this  product directly  or indirectly.   The
  97. software is supplied  "as is" without warranty  of any kind, either expressed
  98. or implied. Warranties of merchantability  or of fitness for  any purpose are
  99. specifically disclaimed.
  100.  
  101. Racontex Manual                                                        Page 2
  102.     
  103.  
  104.  
  105. RACONTEX FEATURES.
  106.  
  107. Many business uses.        In addition  to  the  obvious uses  for  statutes,
  108.                            legal transcripts,  etc Racontex  is valuable  for
  109.                            use with  collective agreements,  policy  manuals,
  110.                            office handbooks,  library catalogues  -- in  fact
  111.                            anywhere that  someone has to  "look something up"
  112.                            and there is a personal computer available.
  113.   
  114. Easy "Intuitive" Search.   Can be started with a  one line command (or from a
  115.                            batch  file  or  menu),   and  prompts  the   user
  116.                            throughout.     Context-sensitive   HELP   screens
  117.                            available at the press of a key. 
  118.   
  119. Contextual Search Tool.    Does not  lose the  context  of pages  found,  can
  120.                            "page up" and "page  down" from each occurrence of
  121.                            the search criteria,  (even if those  pages do not
  122.                            contain  the search  criteria)  and return  to  it
  123.                            instantly by pressing one key.   Moves to next  or
  124.                            previous incidence  of search  criteria by forward
  125.                            arrow or backward arrow keys.
  126.   
  127. Makes full use of display. Supports  50 lines of  on screen  text with  a VGA
  128.                            adapter, 36 lines of text on screen with an EGA or
  129.                            Hercules display as an  alternative to regular  25
  130.                            line text  mode. 36  line display will  fit a full
  131.                            page of court reporters' transcript on  the screen
  132.                            at once.
  133.  
  134. Proximity Search.          Supports  searches   of  word   alternatives   and
  135.                            combinations of alternatives within a given number
  136.                            of words of  each other,  or on  the same  page as
  137.                            each other.
  138.  
  139. File Output.               Supports  file export  of search  occurrence pages
  140.                            either as ASCII, ASCII  with search keys marked or
  141.                            Wordperfect   with    search   keys    in    bold.
  142.                            Alternatively can copy to printer.
  143.  
  144. Variable Stopword List.    Licensees of  the loading  (indexing) program  may
  145.                            specify their own list  of stopwords (words not to
  146.                            be  included  in   searches,  such  as  "and"  and
  147.                            "the") - this is a tremendous disk space saver.
  148.  
  149.  
  150. Racontex Manual                                                        Page 3
  151.     
  152.  
  153.  
  154. Variable Delimiter List.   Licensees of  the loading  (indexing) program  may
  155.                            specify their own  list of delimiters.   e.g. They
  156.                            may  determine  whether a  hyphenated word  is one
  157.                            word or two for search purposes.
  158.  
  159. Self Optimising for Speed. Detects  memory available and loads  either all or
  160.                            part  of  the  file  into  memory  for  sub-second
  161.                            response.    Pages large  files  into  memory  for
  162.                            display (takes a fraction of  a second from a hard
  163.                            drive).
  164.   
  165. Powerful File Compression. Compresses  text  file  to  such  a  degree  that,
  166.                            depending on the stop  word list, all files (text,
  167.                            index and  dictionary) fit  in only  slightly more
  168.                            space than the original ASCII text file.
  169.   
  170. Copyright Protection.      Licensees  of the loading program can market "Self
  171.                            Searching" disk copies of their documents and thus
  172.                            compete with  on-line text  data base  systems for
  173.                            statute  search  etc.  The  search  program  title
  174.                            screen  will  carry  the  copyright  title of  the
  175.                            licensee as well as  the program author.  Both are
  176.                            protected against "zapping"  with a disk modifying
  177.                            utility.
  178.   
  179. "Publisher Pack".          A "Publisher's Package" is available which permits
  180.                            a publisher  to include  the publisher's  client's
  181.                            names in the  protected area of  the title screen,
  182.                            as well  as  the publisher's  name.    Useful  for
  183.                            subscription publishers of statutes etc.  Includes
  184.                            install procedure  requiring on  screen assent  by
  185.                            client to subscription terms.
  186.   
  187. Optional copy prevention.  The  resulting  self searching  documents  may  be
  188.                            loaded  onto  computers  other  than  the original
  189.                            (subject to the appropriate licence) and then made
  190.                            "non-portable" to  prevent  unauthorised  copying.
  191.                            Useful for significant databases in companies with
  192.                            high staff turnover.
  193.  
  194. Easy to Add to Files.      Additional  sections can  be  added  easily  to  a
  195.                            document  in   the  system.     Ideal   for  daily
  196.                            transcript  of  an ongoing  hearing.    The  whole
  197.                            record of a  hearing can be  built up on  the hard
  198.                            drive of a  laptop, and passages  accessed in less
  199.                            than a second.
  200.  
  201.  
  202. Racontex Manual                                                        Page 4
  203.     
  204.  
  205.  
  206. Mouse interface.           If  Racontex detects a mouse,  it may  be used for
  207.                            navigation around the system.
  208.  
  209. Windows Interface          Windows interface in same package as DOS version.
  210.  
  211. On-Line Manual             A  copy of  this manual is  provided on-line  as a
  212.                            RACONTEX database.
  213.  
  214. Racontex Manual                                                        Page 5
  215.     
  216.  
  217.  
  218. LOADING/INDEXING INSTRUCTIONS
  219.  
  220. The  Racontex  search  program  operates  on  a  text  database  produced  by
  221. processing the  document to  be searched  through a  "Loading" process  which
  222. performs  indexing and text  compression.   The loading/indexing  process has
  223. many options to allow for flexibility  in use, but you  do not need to  study
  224. them to get started.
  225.  
  226. Quick Start.
  227.  
  228. There is an INSTALL procedure on  the disk, just put the disk in drive A  and
  229. type in  A:INSTALL and press  ENTER.  It  will set up a  subdirectory on your
  230. hard drive and copy the files into it.
  231.  
  232. (Please note that while the Racontex search program will work adequately on a
  233. "floppy only"  machine, the  loading process is  severely limited  if a  hard
  234. drive is  not available.  However  the loading process may  be performed on a
  235. hard drive computer and the loaded files used on a machine without one.)
  236.   
  237. If you wish to use the version  designed for Microsoft Windows, you may start
  238. the system with the  command  WIN  RCNTXWIN,  and follow the instructions  on
  239. the  screen.   That version  provides a Windows  "front end  processor" which
  240. deals with the dialogue  between you and the  system.  It then  brings up the
  241. search in a full screen window and behaves exactly like the DOS version until
  242. you exit or minimise the window.
  243.  
  244. To prepare a document  for use with the Racontex  search program, simply type
  245. in the  command "LOAD", and when the computer prompts you  for it type in the
  246. name of the text file you want to load.  The load process creates a series of
  247. files all beginning with OUTFILE, which you may rename if you wish. (Although
  248. you may perform  a database creation from  the Windows screen,  it will be  a
  249. little slower than from DOS, because of the overhead which windows imposes.)
  250.  
  251.  To search  those files type in  RACONTEX OUTFILE and follow the  prompts (or
  252. read the  separate instructions on  the use of  the search program).   If you
  253. want to use the search program on another computer (and assuming your licence
  254. permits it), place a formatted floppy disk in your A drive, type in
  255.  
  256.         COPY C:\RACONTEX\RACONTEX.* A:/V 
  257.  
  258. and press enter, then type in
  259.  
  260.         COPY C:\RACONTEX\OUTFILE.* A:/V 
  261.  
  262. and press enter.  You may then run the search program from the floppy disk on
  263. another machine.
  264.  
  265.  
  266. Racontex Manual                                                        Page 6
  267.     
  268.  
  269.  
  270.  
  271. PLEASE NOTE:  Because  many applications require frequent additions to a text
  272. data base (e.g.  daily transcript  of an ongoing  legal proceeding)  the LOAD
  273. command checks  to see if  a suite  of files named OUTFILE  exists and  if it
  274. does, adds the new text to the end.  If you do not want that simply rename or
  275. delete the OUTFILE files.  The load command will remind you of this.
  276.  
  277. MICROSOFT WINDOWS AND RACONTEX.
  278. The windows  program RCNTXWIN  provides  all  of the  functions  of  RACONTEX
  279. through  a  single  window  in  Microsoft  Windows.    If  started  from  the
  280. subdirectory  containing  the  loading programs  which  are  used  to  create
  281. databases, it gives the options to create, rename and delete databases.  If a
  282. search-only  package  of  RACONTEX  is  being  used,  these  options  are not
  283. available and are not offered on the screen.
  284.  
  285. The options  are chosen  via the  "RADIO BUTTONS" at the  bottom left  of the
  286. screen.   Different drives and  directories may be chosen  using the standard
  287. Windows drive  and directory  boxes on  the screen.   Once  a file  has  been
  288. selected by "clicking" on its name in the file or database selection box, the
  289. command button  for starting  the operation  will appear.   For  a search  or
  290. creation operation  the window will  call a DOS window  up, and will  run the
  291. standard RACONTEX programs in it.  If you are not running in "enhanced mode",
  292. the screen will prompt  you to maximise the  icon for the operation.   If you
  293. are running in enhanced mode, the program will start running in a full screen
  294. window, which you may minimise if you wish.
  295.  
  296. When  you are selecting a database for searching,  renaming or deleting, only
  297. the database name appears in the box, although RACONTEX databases consist  of
  298. five files  each.  If you are selecting a file to create a database from, the
  299. full filenames appear.
  300.  
  301. In the "create"  mode a "view file"  command button also  appears.   Clicking
  302. this gives you  a preview of the beginning of  the file you have selected, so
  303. that you may be sure it is  the correct one.  During the viewing of this, the
  304. controls of the window "float" in front of the text.
  305.  
  306. In the "search" mode, a pull down menu at the top of the screen allows search
  307. output options to be  set.  You may select whether  the search display screen
  308. is 25, 36 or 50 lines.  The 50 line mode will usually get  a full page on the
  309. screen at once.  You may also select  whether any WordPerfect files  produced
  310. will be in the format of version 4.2 or version 5.
  311.  
  312. FOR THE MORE TECHNICAL:
  313.  
  314. The foregoing provides sufficient instructions for most applications, however
  315. a fair amount of customisation is possible.
  316.  
  317. Racontex Manual                                                        Page 7
  318.     
  319.  
  320.  
  321. File Names.
  322. A document in Racontex  form consists of a suite of  files, all with the same
  323. name but with different extensions (.NDX  .TXT  .DCT  .SPD  .PGF).   All must
  324. be present  for the  search engine  to work  and all  must be  transferred to
  325. transfer a document  to another computer.   These files are  produced by  the
  326. Loading/Indexing process.
  327.  
  328. Stopwords.
  329. In any text data base  application the most frequent 40 words in the language
  330. take up about  40% of the  disk space.   You do not  usually want to  able to
  331. search for words like AND,  THE and similar words (each occurrence of  a word
  332. which you do wish  to be able to search for takes 10 bytes of  space - if you
  333. do not wish to be able to search for a word it only takes 2 bytes.)
  334.  
  335. A file called STOPWORD  is included, and the  words in that file will not  be
  336. indexed for searching.   You may edit the file with any  ASCII word processor
  337. to change  the selection of stopwords,  or you may delete  it entirely if you
  338. wish every word to be indexed for searching.  Unless you include them in  the
  339. STOPWORD file,  initials are treated as words and it is advisable to STOPWORD
  340. them in  most cases (computer people will  probably not want to  stopword the
  341. initial "C" since  they will want to  index references to  the "C" language.)
  342. The system is "Case Blind",  i.e. although it will display both capitals  and
  343. lower case it treats them as identical  for indexing and searching and it  is
  344. therefore not necessary to STOPWORD "The" if you have done it to "the".
  345.  
  346. If Racontex files  produced by different  runs with different  stopword lists
  347. are merged using  the merge facility referred  to later, the  resulting files
  348. will be stopworded as if the stopword lists had also been merged.  Using this
  349. it  is possible to load  a document with a very  small (or even non-existent)
  350. stopword list and then  apply stopwords later if  storage considerations make
  351. this necessary.  If the Racontex files are still named "OUTFILE" with various
  352. extensions,  this may  be achieved  by changing  the stopword  list and  then
  353. issuing the command INDEX NUL,  which will add no new text but will apply the
  354. new stopwords.
  355.  
  356. Delimiters.
  357. The loading system needs to  know what constitutes a separate word.   A space
  358. always means the end of a word, but what about a hyphen?  A "delimiter" means
  359. a  character  which  indicates  the  end  of a  word,  and  because different
  360. applications may  need a different set of delimiters the system allows you to
  361. change them.
  362.  
  363. For  example, if a  period is embedded in  a word it  may just  mean that the
  364. typist forgot a space and in pure text documents you probably want the period
  365. to be  a delimiter.   However  in a  document listing  radio frequencies  you
  366. probably want "142.299" to be treated as one word and not two.
  367.  
  368.  
  369. Racontex Manual                                                        Page 8
  370.     
  371.  
  372.  
  373. In the file INDEX.BAT the following line appears in two places
  374.  
  375. indbat  %1  outfile   -+\/,.!()[]{};:
  376.  
  377. The string  of characters which looks like  a comic book cuss  word indicates
  378. which characters  will be used  as delimiters.   You may edit this  string to
  379. change  the selection  (remember to do  it in both  places).   If you  do not
  380. include at  least one character  in the delimiter string  the loading process
  381. assumes you forgot and uses !&()-_+=\/,.:;[]{}?<>
  382. as delimiters.
  383.  
  384. Formatting.
  385. The loading  process takes the FormFeed character (ASCII 12)  as the end of a
  386. "logical page", even though that may require more than one  screen to display
  387. a  page in the  Racontex search program.   That  logical page is used  in the
  388. search program when  a search is made for words  on the "Same Page".   If you
  389. are formatting a text file specifically for use with Racontex you should bear
  390. in mind your  screen characteristics to make  your searches as convenient  as
  391. possible.  If the searches will be performed on a "text only"  system or on a
  392. system with a Color Graphics Adapter  (CGA) there is room for 24  lines of 80
  393. characters each on the search screen at  once.  EGA will allow 35 lines of 80
  394. characters each, VGA 49 lines  of 80 characters each and Hercules will  allow
  395. 35 lines of 90 characters wide.  If the text file does not match these, there
  396. is no real problem as the search program will "wrap"  lines that are too wide
  397. and will "scroll" pages that are too long.
  398.  
  399. Since the objective  is to maximise  use of  the display screen,  "nul" lines
  400. often used for double spacing are eliminated.   If there is a requirement for
  401. a  blank line to  appear on the  display, include  at least one space  on the
  402. line.
  403.  
  404. If you  are preparing a copy of a file where paragraphs of it for some reason
  405. are logical units  (e.g. sections  of a  statute, procedure  manuals, library
  406. catalogues etc.) it often helps to set them up as "logical pages" so that the
  407. "same page" search will find combinations of words in the same paragraph.
  408.  
  409. Merging Files
  410. The  system provides the means to merge documents  produced by different runs
  411. of the Loader/Indexer.  You just enter the command
  412.  
  413.        MERGE  filea  fileb  filec 
  414.  
  415. where  filea and  fileb are  the names  of the suites  of files to  be merged
  416. (without extension  but optionally with pathnames) and filec is  the name the
  417. merged suite of  files is to  be given  (and cannot be  the same as  filea or
  418. fileb). 
  419.  
  420. Racontex Manual                                                        Page 9
  421.     
  422.  
  423.  
  424. Please note  that  the  merge  facility  will  not merge  files  produced  by
  425. different  licensed  copies   of  the  Loader/Indexer  (this   is  to   avoid
  426. compromising the copyright notice of  those who publish documents in Racontex
  427. form with their own copyright notice showing on the title screen). 
  428.  
  429. Copy Prevention
  430.  
  431. Once   RACONTEX database  files have been  installed on  a particular machine
  432. they may be "FIXED" on that machine.  This does not prevent their being moved
  433. to other  locations on  that machine  or backup  copies being  made, but  the
  434. copies will  only work with  a copy of  RACONTEX on that machine.   If run on
  435. another machine the only action will  be to display a message to that effect.
  436. (If run on another machine  with an earlier version of Racontex, the  message
  437. reports "Files damaged or altered", if run with a current  version version of
  438. Racontex the message says "Removed from machine authorised to run" it.) 
  439.  
  440. This is achieved  by using  the program RCNTXFIX.EXE.   The command  RCNTXFIX
  441. FILEA will render  non-portable the database  files with the  filename FILEA.
  442. If run on  files produced by an unregistered version, this may be reversed by
  443. running the UPDATE program.  Since the  UPDATE program will not work on files
  444. produced by  a registered version, such  files will remain  "fixed" no matter
  445. what.
  446.  
  447. This feature  prevents  copies  of a  database  being  made  by  unauthorised
  448. persons.   The  originals are  normally  kept  by an  authorised  person  and
  449. installed on the user machine by that person and then "RCNTXFIX"ed.
  450.  
  451. Additionally, the  ability to do a one key unload of  the whole database to a
  452. file  is disabled by the "fixing" process, to  protect the copyright of those
  453. using RACONTEX  to publish proprietary  material.  The optional  "Publishers'
  454. Package" produces an "install" procedure which automatically "fixes" files as
  455. they are installed on a client's machine.
  456.  
  457. For the REALLY technical:
  458.  
  459. The loading process operates as follows:
  460.  
  461. The LOAD command invokes a batch file LOAD.BAT which calls a program BREAKIT.
  462. If the file you instruct it to load is longer than 200kb this program creates
  463. working files by  breaking up the  input file into  a series of files  (named
  464. P!.1,  P!.2 etc) each no  greater than  about 200kb.   It then writes  a file
  465. INDEX1.BAT consisting of one line INDEX  P!.1 P!.2 ...etc.  After BREAKIT has
  466. executed LOAD.BAT chains  to INDEX1.BAT  which in  turn calls  INDEX.BAT (the
  467. main loading "engine").
  468.  
  469. INDEX.BAT takes as parameters the names of  the files to be indexed and added
  470. to the OUTFILE.* database files.  For custom applications you may replace the
  471.  
  472. Racontex Manual                                                       Page 10
  473.     
  474.  
  475.  
  476. LOAD.BAT  front end  process with  your own  program provided that  it leaves
  477. input files not significantly larger than 200kb, and is followed by a call to
  478. INDEX.BAT.   (If you know that your files  are within the size  limit you may
  479. initiate the process by calling INDEX.BAT directly.)
  480.  
  481. For example  you may have an application designed to print a document (e.g. a
  482. library catalogue, Rolodex cards etc) with a standard number of heading lines
  483. on  each  page or  with  some  consistent separator  for  "logical  pages" of
  484. information.  You  could write a  simple BASIC  program which will  read that
  485. file,  ignoring the heading lines  and inserting  FormFeed characters between
  486. the  logical  pages,  and  writing out  a  series  of files  for  input  into
  487. INDEX.BAT.
  488.  
  489. The file size  limitation is  there because Racontex  can handle  files whose
  490. index would be too  large to fit into  memory and it therefore loads them  by
  491. indexing sections and merging the indexed sections on the hard disk.
  492.  
  493. The programs used by INDEX.BAT are described below:
  494.  
  495. INDBAT.EXE file1 file2 delimiters
  496. Reads in file1 and produces output files named  file2 with various extensions
  497. using delimiters  as given (see above  re delimiters). Defaults: file1=INFILE
  498. file2=OUTFILE.
  499.  
  500. MERGBAT.EXE filea fileb filec
  501. Merges files produced  by INDBAT.EXE, filea is the  name of the first  set of
  502. input files (without extension) fileb is the same for the second set of input
  503. files  and filec is the  name to be assigned  to the output  files.  Defaults
  504. filea=INFILE1  fileb=INFILE2 filec=OUTFILE.
  505. Note that before  running MERGBAT.EXE it  is necessary to  rename "filea".TXT
  506. (i.e. the file with the extension .TXT produced by INDBAT.EXE) as "filec".TXT
  507. as is done in INDEX.BAT.  
  508.  
  509. As  inspection of INDEX.BAT  will show,  the process of indexing  and merging
  510. will continue until all of the files named on the INDEX.BAT command line have
  511. been processed.
  512.  
  513. Please note that it is necessary to copy the file  LICENCE.PGF to "filec".PGF
  514. after all of the indexing and merging.
  515.  
  516. SPEEDIND filec
  517. Examines the output files denoted by filec (defaults to OUTFILE) and writes a
  518. file used  later by the Racontex search program in conjunction with the other
  519. files produced by INDBAT.EXE and MERGBAT.EXE.
  520.  
  521.  
  522.  
  523. Racontex Manual                                                       Page 11
  524.     
  525.  
  526.  
  527. If the loading  process detects errors  during the run, it writes  details of
  528. the  errors  to  a file  called  RCNTXERR.LST,  and  INDEX.BAT  warns  of the
  529. existence of such a file.
  530.  
  531. Program Limitations.
  532. At present the system is limited  to documents of 16000 pages long  or less -
  533. there is no limitation to page size.
  534.  
  535. The system is a  "database" type system in that each  word found in the input
  536. is stored only once (in lower case)  and all subsequent references to it  use
  537. pointers and  case flags.   The  "dictionary" must  reside in  memory and  is
  538. limited to 65000  bytes -  this is always  adequate since  it allows  for the
  539. storage of  over 10,000 different words for use in  a given document and most
  540. people have a normal vocabulary smaller than this (also a  document is likely
  541. to refer to a sub-set  of human experience and  therefore use a more  limited
  542. vocabulary).    If  the  loading system  runs  out  of dictionary  space,  it
  543. continues to  run but substitutes ?  for the word it  cannot store and writes
  544. the word with  an appropriate  message to  the RCNTXERR.LST  file).   In this
  545. extremely unlikely event you may elect to leave the document with the odd "?"
  546. in it or break up the document into two sections and handle each section as a
  547. separate document.
  548.  
  549. The only other limitation  is the size of the hard  disk on the machine being
  550. used.   Because the loading  program substantially compresses the  text it is
  551. not uncommon (with  an appropriate stopword  list) for the output  files from
  552. the loading process to be smaller in total than the input text file.
  553.  
  554.  
  555. Racontex Manual                                                       Page 12
  556.     
  557.  
  558.  
  559.  
  560. SEARCH SYSTEM INSTRUCTIONS
  561.  
  562. This system  is designed for  the RApid  CONTEXtual search  of documents  for
  563. keywords  and combinations  of words.  It  works quickly  because it operates
  564. mainly in  memory - bringing in a specially prepared copy of the document and
  565. then working  on it  (if your  machine has  insufficient memory  to hold  the
  566. document - often  the case with large  documents like statutes, Racontex will
  567. "page" the files into memory at a slight penalty in speed - if you use a hard
  568. drive you  will not notice the  difference).  The  program will only  work on
  569. documents  prepared by  licensed  users of  its companion  index  preparation
  570. system  and  will  display  on   its  title  screen  the  licensing  details.
  571. (Companies wishing to market documents in this form should contact the author
  572. to discuss royalty arrangements.)
  573.  
  574. Simple Searches.
  575.  
  576. The program is  invoked by  typing at  the A> prompt  (C> or  D> with  a hard
  577. drive):
  578.  
  579.             RACONTEX [FILE]
  580.  
  581. where [FILE] is the  name of the prepared document file  set.  For example to
  582. search the copy of the Industrial Relations Act saved as IRACT you would type
  583. RACONTEX IRACT (if you use a menu system, selecting the appropriate menu item
  584. would do this for you).
  585.  
  586. If you use  a hard drive you may  copy all of the  files on the  distribution
  587. disk to that drive, and then run the program from its prompt (usually C>).
  588.  
  589. Display Options.
  590.  
  591. Racontex  will  detect whether  you  have a  colour card  installed  for your
  592. monitor, and will use colours to enhance the menu if it finds one.  Sometimes
  593. a  computer has  a colour card installed,  but uses  a monochrome  monitor (a
  594. common situation with  laptops using  liquid crystal  screens, and  VGA (e.g.
  595. PS/2  50) machines with monochrome  monitors) which  causes some menus  to be
  596. difficult to read.  In that situation Racontex may be invoked by
  597.  
  598.             RACONTEX [FILE]/m
  599.  
  600. and it will use its monochrome setup whether or not a colour card is in use.
  601.  
  602. Racontex cannot always get  a whole page of a document  on the screen, and in
  603. this case it displays  the page a screen  at a time.  The  standard method of
  604. moving down such a page is to show each screen full separately, since this is
  605. the fastest method of display (particularly with liquid crystal screens).  An
  606.  
  607. Racontex Manual                                                       Page 13
  608.     
  609.  
  610.  
  611. optional method is to  "scroll" the screen like  credits on a film, and  this
  612. may be preferable if the  pages of a document  are only slightly longer  than
  613. the screen.  This option is selected by invoking Racontex by
  614.  
  615.             RACONTEX [FILE]/s
  616.  
  617. (If both of the above are wanted, use RACONTEX [FILE]/m/s)
  618.  
  619. If Racontex detects that your computer  has a graphics card which can support
  620. more than 25 lines of text on the screen (Hercules, EGA or VGA) it will offer
  621. you the  opportunity to switch to  graphics mode in order to get  more of the
  622. page on the screen (36 lines for EGA and Hercules, 50 lines for VGA).  If for
  623. some  reason you do not  want  to  be offered this  choice (e.g. the slightly
  624. slower screen writing is a concern, or you don't like the smaller letters, or
  625. your display is not fully IBM compatible) you may force the non-graphics mode
  626. to be used by invoking Racontex by
  627.  
  628.            RACONTEX [FILE]/ng
  629.  
  630. If Racontex detects a mouse, it  will allow you to use it  to navigate around
  631. the screens.  If you do not  wish this you may disable it by adding   /nm  as
  632. a start up option)
  633.  
  634.  
  635. If your  system  has a  problem  with programs  which write  directly to  the
  636. hardware, add the option /DV and the program will use DOS  Video calls, which
  637. are slower but may avoid some problems.
  638.  
  639.  
  640. The program will now load itself  and the files it needs to operate and after
  641. a little chugging around will display "press any key to continue".  After you
  642. have pressed a key it will display a screen like this:
  643.  
  644.    
  645. |Word to find?                                                              |
  646. |                                                                           |
  647. |      [ENTER] then [ESC] to quit. [F9] to display first page. [?] for help  |
  648.  
  649.    
  650. Note that whenever you see a question mark "?" in the menu  bar at the bottom
  651. of the screen you may display a help screen by pressing the [?] key.
  652.  
  653. At this point  you may press [F9] to jump  straight to the first  page of the
  654. document, or you may enter a word to search for.
  655.  
  656. If you  are searching the Industrial Relations Act for references to the word
  657. "oath", you would type in "oath" and press enter, like this:
  658.  
  659. Racontex Manual                                                       Page 14
  660.     
  661.  
  662.  
  663.  
  664.    
  665. |Word to find? oath                                                         |
  666. |                                                                           |
  667. |      [ENTER] then [ESC] to quit. [F9] to display first page.  [?] for help|
  668.    
  669. and the computer would respond:
  670.  
  671.    
  672. |Word to find? oath                                                         |
  673. |       oath 9 occurrences                                                  |
  674. |                                                                           |
  675. |[ESC]=Quit [F1]=OR [F2]=Same Page[F3]=Word Proximity[F8]=Tally[F9]=Dsply[?]|
  676.    
  677.  
  678. You could then press [F9] and the computer would display:
  679.  
  680.    
  681. | Evidence                                                                  |
  682. |  19.  (1)  The council may receive and accept such evidence and information
  683. | on oath, affidavit or otherwise as in its discretion it considers proper, |
  684. | whether or not the evidence is admissible in a court of law.              |
  685. |    (2)  The council may request and receive a report from a person it     |
  686. | appoints to investigate an application or to investigate and attempt to   |
  687. | settle a dispute under this Act, a collective agreement or the regulations.
  688. | The council may, in its discretion, in a proceeding or class of proceedings
  689. | consider the contents of a report without disclosing them to any party.   |
  690. |                                                                           |
  691. |[ESC] [P] [PGDN] [PGUP] [END] [HOME] [<-] [v] [->] [^] ([?] for help)      |
  692.    
  693. Notice how the word "oath" is highlighted on the screen.
  694. {In these instructions [v] represents the down  arrow and [^] represents  the
  695. up  arrow  because  some  printers  object  to  the  codes  for   the  actual
  696. characters.}
  697.  
  698. The "menu"  at the bottom of  the screen allows  you to navigate  through the
  699. document.  In the example given, the Industrial Relations Act has been set up
  700. with one "page" equal  to one section (note that some  "pages" fill more than
  701. one screen).   Therefore the  key [PGUP]  takes you  to the  previous section
  702. (i.e. Section 18),  [PGDN] takes you to  the following section, [HOME]  takes
  703. you  to the beginning of  the Act and [END] takes you to  the end of the Act.
  704. The  arrow keys take you  around the pages your search  found, [<-] will take
  705. you to the previous section containing your search key, [->] will take you to
  706. the next one, [^]  will take you to the  top of your current  page (it may be
  707. too long to fit on the screen) and [v] will take you to the current  one (you
  708. may have moved away from it with the [PGUP] and [PGDN] keys.  [ESC] will take
  709.  
  710. Racontex Manual                                                       Page 15
  711.     
  712.  
  713.  
  714. you back to  search for a  different set of key words.   In this case  we hit
  715. [->] and the computer displayed:
  716.  
  717.    
  718. | Summons and discovery of documents                                        |
  719. |  20.  On the recommendation of an officer appointed under section 8 or 96,|
  720. | or on its own motion, the council has power to summon and enforce the     |
  721. | attendance of witnesses and compel them to give oral or written evidence on
  722. | oath and to produce the documents and things the officer or the council   |
  723. | considers requisite to the full investigation and consideration of matters|
  724. | within his or its jurisdiction in the same manner as a court of record in |
  725. | civil cases.                                                              |
  726. |                                                                           |
  727. |[ESC] [P] [PGDN] [PGUP] [END] [HOME] [<-] [v] [->] [^] ([?] for help)      |
  728.  
  729.    
  730. Word Proximity Searches
  731.  
  732. Sometimes the  computer indicates that there are too many instances of a word
  733. for anyone to want to look at  all instances (try "picket$" in the Industrial
  734. Relations Act -  the $ [or %  or * for  those familiar with  other "wild card
  735. characters"] indicates that  you want  all words  beginning with  picket, and
  736. would  include pickets, picketing etc.)   In that case you  might want to try
  737. combining it with another word.  In our  example we could look for oath  only
  738. within a given  number of words of  some other word, in  this case "eviden$".
  739. To  do this  we select  "word proximity" from  the "word  to find"  screen by
  740. pressing [F3] on that screen, and the computer responds with:
  741.  
  742.    
  743. |                                                                           |
  744. |[F1]=Adj [F2]=Within 2 words [F3]=4 [F4]=8 [F5]=16 [F6]=32 [F7]=64 [F8]=128|
  745. |                                                                           |
  746.  
  747.    
  748.  
  749. To tell it that we  only want to look for our  next word within sixteen words
  750. of the last one, we press [F5] and then see:
  751.  
  752.  
  753.    
  754. |                                                                           |
  755. |Word to find?                               within 16 words of previous set|
  756. |                                                                           |
  757. |                                                                           |
  758. |      [ENTER] then [ESC] to quit.                   [?] for help           |
  759.  
  760.    
  761.  
  762. Racontex Manual                                                       Page 16
  763.     
  764.  
  765.  
  766. to which we respond as follows, and get the result shown:
  767.  
  768.     
  769. |Word to find? eviden$                       within 16 words of previous set|
  770. |   evidence 31 occurrences                                                 |
  771. | evidentiary 1 occurrence                                                  |
  772. |                                                                           |
  773. |[ESC]=Quit [F1]=OR [F2]=Same Page [F3]=Word Proximity[F8]=Tally[F9]=display|
  774.  
  775.    
  776. This time when we press [F9] we get the following result:
  777.  
  778.    
  779. | Evidence                                                                  |
  780. |   19. (1)  The council may receive and accept such evidence andinformation 
  781. | on oath, affidavit or otherwise as in its discretion it considers proper, |
  782. | whether or not the evidence is admissible in a court of law.              |
  783. |    (2)  The council may request and receive a report from a person it     |
  784. | appoints to investigate an application or to investigate and attempt to   |
  785. | settle a dispute under this Act, a collective agreement or the regulations.
  786. | The council may, in its discretion, in a proceeding or class of proceedings
  787. | consider the contents of a report without disclosing them to any party.   |
  788. |                                                                           |
  789. |                                                                           |
  790. |[ESC] [P] [PGDN] [PGUP] [END] [HOME] [<-] [v] [->] [^] ([?] for help)      |
  791.  
  792.    
  793. Notice that both "oath" and  "evidence" ( also "evidentiary") are highlighted
  794. and how only pages containing both words are displayed as you proceed through
  795. the document using the [->] key.
  796.  
  797. Sometimes it is  necessary to find a  combination of one of several  words in
  798. combination with one of another set of words.  e.g. to find all references to
  799. picketing an ally you would need to find the combinations given by:
  800.  
  801. picket$
  802. [F3] or [F2]  (word proximity or same page)
  803. Ally
  804. [F1]          ("or")
  805. Alli$         (to catch "allies" "allied" etc)
  806. [F9]          ("display")
  807.  
  808. The proximity  search may  continue  for as  many proximity  combinations  as
  809. needed,  but it must be remembered that what  the proximity "engine" is doing
  810. is dropping  out references to  the first search  key set found which  do not
  811. satisfy each  succeeding condition.    To assist  this process  the  computer
  812. displays a  history of  "The Search  So Far"  in a  box at the  right of  the
  813.  
  814. Racontex Manual                                                       Page 17
  815.     
  816.  
  817.  
  818. screen.  At the  end of each set  of "OR" conditions (indicated by  selecting
  819. some key other than F1) the computer performs this dropping out operation and
  820. displays the number  of pages  remaining which  satisfy the  search criteria.
  821. When  F9  is selected  those remaining  occurrences  are displayed.    The F8
  822. "Tally" option is provided to allow a display of the number of hits remaining
  823. before the  "display" option is selected so that if too many remain a further
  824. criterion may be specified.
  825.  
  826. Printer and File Output.
  827.  
  828. When you have a document displayed on the screen, another choice shown on the
  829. menu is [P].  Pressing the P key will tell the system that you wish to have a
  830. copy  of the  current page  (or - for  files not  protected with  the RCNTFIX
  831. feature - all pages or those pages with "found" occurrences) printed for some
  832. purpose.  The  first time you press the P key, you will be  given a choice of
  833. output forms.  You may either direct the output to your printer  or to a file
  834. for later printing, or for incorporation in some other document.  It makes it
  835. easier to find if you include  the pathname of your word processing directory
  836. in  the file  name (otherwise  the file  will be  placed in the  DOS "current
  837. directory").
  838.  
  839. You may also select a file output format for later use.   If you select plain
  840. ASCII, the file  produced will contain straight  text.  If  you select  ASCII
  841. with {}  highlighting, the keywords will  appear in the file enclosed  in { }
  842. brackets.  You may  then use your word processor to  change these to whatever
  843. code it uses to turn on and off whatever form of highlighting you require.  
  844.  
  845. If you  select WordPerfect with bold, the file will be written in WordPerfect
  846. format, with the keywords set to bold print.  The  file  will be  produced in
  847. WordPerfect version 5.0.    WordPerfect 5.1 will also  read this file format.
  848. If you require a file in WordPerfect 4.2 format, start up RACONTEX with /WP42
  849. as  an option   on  the command  line (in  Windows, select from  the pulldown
  850. menu).     
  851.  
  852. If a file with the name you give exists, the new information will be appended
  853. to it, and  if you specified  WordPerfect format,  RACONTEX will add  its new
  854. information in the same version.  
  855.  
  856.